WINTERMUTE: Add keymappings #2051

lolbot-iichan · 2020-02-09T03:31:25Z

No description provided.

bgK · 2020-02-09T14:28:44Z

engines/wintermute/detection.cpp

+
+		Common::KeymapArray result = Keymap::arrayOf(engineKeyMap);
+
+		Common::String targetString = target;


The target is user-controlled. It's possible to edit it when adding a game. Is fetching the gameid from the configuration manager not working for you? Common::String gameId = ConfMan.get("gameid", target);

Thanks! Never noticed "gameid" property before.

lolbot-iichan · 2020-02-13T02:26:14Z

Current state of this PR:

Standard in-game controls & game-specific controls for all 90+ games listed at https://wiki.scummvm.org/index.php?title=Wintermute/Controls are all added to detection.cpp, except for "onehelluvaday" demo, which features an action binded to Shift keypress. It seems that currently it's impossible to either add default input mapping for Shift, or assign it manually with GUI. Original inputs are all marked with "//original [keyboard|mouse|joy]" comments.
Text input engine-hardcoded controls are still hardcoded, I don't plan to change it in this PR.
Extra keyboard input mappings (UP+DOWN or PGUP+PGDN) are added for a couple of games. They are marked with "// extra keyboard". Ideas begind assigning extra keyboard keys:

original keymaps are never changed, if both UP+DOWN and PGUP+PGDN is already used, then nothing is added.
if game is using mouse wheel and does not use UP+DOWN or PGUP+PGDN pair -> map one of them to the mouse wheel

Extra joystick mappings are added for all games. They are marked with "// extra joy". Ideas behind assigning JOY buttons:

All games are using LMB=JOY_A, RMB=JOY_B, ESC=JOY_X.
Game's most useful action (usually, HINTS or INV) is binded to JOY_Y.
If game has paired controls like scrolling, changing pages, walking, switching between 2 GUI types -> assign those to JOY arrows.
A few games features unpaired actions binded to JOY_LEFT and/or JOY_RIGHT (like, Face Noir's INV on JOY_LEFT and HINTS on JOY_Y). I'm not sure if it's ok or not to call commands with DPAD keys. Maybe JOY_R+Y would be nice to have, maybe not - not use...
Enter is curretly unmapped to JOY. It would be really nice if JOY_R+JOY_X would be allowed for Enter. Almost all of listed games are using Enter at windows like "Are you sure you want %s", but I'm not sure if it's a shortcut for OK button in all the games or some games are not fully playable without ability to press Enter. I'd better have a JOY mapped combo for it, just in case some game absolutely require it.
All cheats are unmapped to JOY. It would be really nice if JOY_R+JOY_B combo would be allowed for cheats & secrets. FoxTail has 2 cheats, for JOY_R+JOY_A would be useful as well.

Extra mouse input mappings (MOUSE_WHEELUP+MOUSE_WHEELDOWN, MOUSE_MIDDLE) are added. They are marked with "// extra mouse". Ideas behind assigning extra MOUSE buttons:

original keymaps are never changed, if MOUSE_MIDDLE and/or MOUSE_WHEELUP+MOUSE_WHEELDOWN are already used, rules below does not apply.
If MOUSE_RIGHT is not actually used, it may be remapped (used only for "Wilma Tetris", which does not use RightClick event).
JOY_Y has some action -> assign MOUSE_ MIDDLE to the same action (except for Face Noir, where INV action is mapped to MOUSE_MIDDLE in original keymap, while I chose HINTS to be assigned to JOY_Y).
If game has paired controls like scrolling, changing pages, switching between 2 GUI types -> assign those action assigned to MOUSE_WHEELUP/MOUSE_WHEELDOWN arrows

bgK · 2020-02-13T07:03:21Z

Humongous work! We can merge this whenever you feel it's ready.

It seems that currently it's impossible to either add default input mapping for Shift, or assign it manually with GUI.

I'll look into fixing that, there is no reason not to be able to remap the modifier keys.

lolbot-iichan · 2020-02-13T22:32:53Z

Humongous work! We can merge this whenever you feel it's ready.

Thanks! I guess I'll wait for #2052 to complete and will do a rebase, since my branch conflicts with that PR.

Meanwhile, current open questions:

Should I add JOY_R+JOY_X for Enter or leave it unmapped?
Should I add JOY_R+JOY_B for secrets or leave them unmapped?
If at least one of those is yes, then what is the syntax? act->addDefaultInputMapping("JOY_R+JOY_X") does not seem to work for me (GUI does not list this combo).

bgK · 2020-02-14T05:02:12Z

Should I add JOY_R+JOY_X for Enter or leave it unmapped?
Should I add JOY_R+JOY_B for secrets or leave them unmapped?

At the moment, joystick button combos are not expressible using the keymapper. I suggest leaving those actions unmapped with a comment describing the ideal bindings. Users can map them to device specific buttons (triggers, stick press, right stick axes) if needed.

bgK · 2020-02-14T18:33:07Z

It seems that currently it's impossible to either add default input mapping for Shift, or assign it manually with GUI.

I'll look into fixing that, there is no reason not to be able to remap the modifier keys.

Done in 29dd15a.

bluegr · 2020-02-16T11:00:52Z

engines/wintermute/detection.cpp

+		act = new Action("RETURN", _("Confirm"));
+		act->setKeyEvent(KeyState(KEYCODE_RETURN, ASCII_RETURN));
+		act->addDefaultInputMapping("RETURN"); // original keyboard
+//TODO: extra joy control, e.g. "JOY_R+JOY_X"


Please, indent all of these TODO comments properly (more follow below, no reason to repeat this comment)

Intended in line with code with tabs.

bluegr · 2020-02-16T11:02:32Z

Extraordinary work! Well done!

Could you please fix the indentation of the TODO comments? Other than that, it's an amazing effort, kudos!

Those 4 keys are enough to complete most game: https://wiki.scummvm.org/index.php?title=Wintermute/Controls

lolbot-iichan · 2020-02-16T21:41:57Z

Rebased, removed debugger handling (it's already done at #2052), added Shift hotkey for One Helluva Day demo, moved TODOs to the right.

Done in 29dd15a.

Thanks, supported that at 9e267aa.

Could you please fix the indentation of the TODO comments?

Fixed at 9e267aa.

We can merge this whenever you feel it's ready.

I feel it's ready.

ccawley2011 · 2020-02-13T12:12:04Z

engines/wintermute/detection.cpp

+			gameId == "rhiannon" ||
+			gameId == "shinestar"
+		) {
+			act = new Action("SKIP", _("Skip"));


Suggested change

act = new Action("SKIP", _("Skip"));

act = new Action(kStandardActionSkip, _("Skip"));

Thanks, fixed! Maybe we should also introduce more Standard Actions for things like "HINT", "WTF", "ACTNXT", "PAGEDN", "SCRLUP", etc?

Yes, feel free to add some. I'm not convinced standard actions are very useful at the moment. We set the default bindings for mouse+keyboard and gamepad when we define the actions. The backend changing the defaults for the standard actions is very likely to result in nonsensical / conflicting keymaps.

One possible future change is the evolution of the virtual keyboard into some sort of more general touch oriented on-screen input method. Having standard actions in that context would be nice as we could bundle a set of corresponding icons.

engines/wintermute/detection.cpp

ccawley2011 · 2020-02-13T12:23:29Z

engines/wintermute/detection.cpp

+//TODO: extra joy control, e.g. "JOY_R+JOY_B"
+			gameKeyMap->addAction(act);
+
+			act = new Action("DBG", _("Debug print"));


This has the same ID as the action for opening the debugger. I suggest renaming it to something else.

Renamed to "DBGTXT", thanks for pointing this.
@bluegr @ccawley2011 @bgK Should we introduce some convention to avoid things like this in the future? Like, "non-standard actions IDs should always be 6+ characters long"?

Well the action ids are namespaced by the keymap names. There was no real conflict here. The only issue is if a backend sets a default for a standard action that happens to have the same name as game action. I'm not sure it's worth the effort of enforcing a naming convention just for that.

engines/wintermute/detection.cpp

lolbot-iichan · 2020-02-18T00:29:32Z

Fixed errors from above + splited "5ma||5ld||dirtysplit||projectjoe" keymap into two, since they slightly different original controls + fixed action ID collision at Alpha Polaris.

bluegr · 2020-02-19T06:04:17Z

Great work, once again! Thanks for fixing the pending issues. Merging

lolbot-iichan requested a review from bgK February 9, 2020 13:47

lolbot-iichan changed the title ~~WINTERMUTE: Support keymapping (WIP)~~ WINTERMUTE: Add keymapping (WIP) Feb 9, 2020

lolbot-iichan changed the title ~~WINTERMUTE: Add keymapping (WIP)~~ WINTERMUTE: Add keymappings (WIP) Feb 9, 2020

bgK reviewed Feb 9, 2020

View reviewed changes

lolbot-iichan force-pushed the wme_mapping branch from 9a02972 to 97b71a3 Compare February 9, 2020 21:20

ccawley2011 mentioned this pull request Feb 11, 2020

BACKENDS: Add events for additional mouse buttons #2055

Merged

lolbot-iichan force-pushed the wme_mapping branch from c9f982a to 0586e42 Compare February 13, 2020 01:36

lolbot-iichan changed the title ~~WINTERMUTE: Add keymappings (WIP)~~ WINTERMUTE: Add keymappings Feb 13, 2020

bgK approved these changes Feb 13, 2020

View reviewed changes

bluegr reviewed Feb 16, 2020

View reviewed changes

lolbot-iichan added 4 commits February 17, 2020 00:09

KEYMAPPER: Enable remapping of the mouse wheel

b053cdd

WINTERMUTE: Handle Ctrl&Shift at BaseKeyboardState

2274f32

WINTERMUTE: Add minimal keymapping

fae8ac2

Those 4 keys are enough to complete most game: https://wiki.scummvm.org/index.php?title=Wintermute/Controls

WINTERMUTE: Keymaps for most games

9e267aa

lolbot-iichan force-pushed the wme_mapping branch from 0586e42 to 9e267aa Compare February 16, 2020 21:23

ccawley2011 reviewed Feb 16, 2020

View reviewed changes

WINTERMUTE: Fix game keymappings

718f8c6

bluegr merged commit 887db8a into scummvm:master Feb 19, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

WINTERMUTE: Add keymappings #2051

WINTERMUTE: Add keymappings #2051

lolbot-iichan commented Feb 9, 2020

bgK Feb 9, 2020

lolbot-iichan Feb 9, 2020

lolbot-iichan commented Feb 13, 2020 •

edited

bgK commented Feb 13, 2020

lolbot-iichan commented Feb 13, 2020

bgK commented Feb 14, 2020

bgK commented Feb 14, 2020

bluegr Feb 16, 2020

lolbot-iichan Feb 16, 2020

bluegr commented Feb 16, 2020

lolbot-iichan commented Feb 16, 2020 •

edited

ccawley2011 Feb 13, 2020

lolbot-iichan Feb 17, 2020

bgK Feb 18, 2020

ccawley2011 Feb 13, 2020

lolbot-iichan Feb 18, 2020 •

edited

bgK Feb 18, 2020 •

edited

lolbot-iichan commented Feb 18, 2020

bluegr commented Feb 19, 2020


		Common::KeymapArray result = Keymap::arrayOf(engineKeyMap);

		Common::String targetString = target;

	act = new Action("SKIP", _("Skip"));
	act = new Action(kStandardActionSkip, _("Skip"));

WINTERMUTE: Add keymappings #2051

WINTERMUTE: Add keymappings #2051

Conversation

lolbot-iichan commented Feb 9, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lolbot-iichan commented Feb 13, 2020 • edited

bgK commented Feb 13, 2020

lolbot-iichan commented Feb 13, 2020

bgK commented Feb 14, 2020

bgK commented Feb 14, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bluegr commented Feb 16, 2020

lolbot-iichan commented Feb 16, 2020 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lolbot-iichan Feb 18, 2020 • edited

Choose a reason for hiding this comment

bgK Feb 18, 2020 • edited

Choose a reason for hiding this comment

lolbot-iichan commented Feb 18, 2020

bluegr commented Feb 19, 2020

lolbot-iichan commented Feb 13, 2020 •

edited

lolbot-iichan commented Feb 16, 2020 •

edited

lolbot-iichan Feb 18, 2020 •

edited

bgK Feb 18, 2020 •

edited